home *** CD-ROM | disk | FTP | other *** search
/ Inside Mac Games Volume 5 #8 / IMG 51 Vol 5-8.iso / Goodies / More For Your Games / MacMAME / MacMAME Read Me First! < prev    next >
Text File  |  1997-10-18  |  7KB  |  116 lines

  1. MacMAME 0.29
  2.  
  3. Ported in alphabetical order by:
  4.  
  5. John Butler (jcbutler@pobox.com)
  6. Aaron Giles (agiles@sirius.com)
  7. Brad Oliver (bradman@primenet.com)
  8.  
  9. Special thanks to:
  10.  
  11. Nicola Salmoria (MC6489@mclink.it) and Mirko Buffoni for being the coordinators of the MAME project.
  12. David Caldwell (david@indigita.com) for doing MacMultiPac, MAME's predecessor and the Jr. Pac-Man driver
  13. Andrew McCarty (andros@andros.seanet.com) for the cool icons.
  14. "Steve" at Apple for the fast blitting code in earlier versions
  15. Ernesto Corvi provided earlier versions of the sound code used by many games.
  16. John Stiles and Richard Bannister for constant programming tips, code donation, & general help and support.
  17. Michael R. Simmons (macguitar@aol.com), beta-tester extraordinaire for finding the bugs.
  18. Y. Nemoto, author of MacMoon for providing competition and general encouragement.
  19. David Wareing for the PPC Control Strip hiding code.
  20. Dave Warker, for finding some bugs in the Mac code that caused crashes under MacOS 8.
  21. Evan Olcott (eolcott@triplo.com) for the front-end code.
  22. Phil Stroffolino (phil@maya.com) for the save/restore code
  23. Raul (raul@silva.com) for the "About" dialog picture.
  24. Dave Marli, for his arcade emulator high score page and a ton of other stuff.
  25.  
  26. Thanks go out to everyone for their fine work! The MacMAME homepage can be found at http://www.primenet.com/~bradman/mame
  27.  
  28. There is a German version of MacMAME. It can be found at
  29. http://www.h-o-c.com
  30.  
  31. This program costs nothing and I expect nothing for it. However, I'd be more than happy to accept donations. If you'd like to contribute something, here's a list of things you can do:
  32.  
  33. * Donate $10 to your favorite charity
  34. * write a MAME module for your favorite arcade game
  35. * send me a postcard
  36.  
  37. If you'd like to send me something, my address is:
  38. Brad Oliver
  39. 202 E Baseline #372
  40. Tempe AZ 85283
  41.  
  42. What is MacMAME?
  43.  
  44. In a nutshell, MAME attempts to emulate as closely as possible the original hardware of the early eighties arcade games. As we discover how a game works, support for it is added to the emulator. This is happening at a rapid pace, so be sure to check back often for the latest release of MAME. 
  45.  
  46. To run the games, you need the ROM images, in a package that MacMAME understands. A program called MAME Converter can be found on the MacMAME homepage (http://www.primenet.com/~bradman/mame/macmame.html). You can use it to make MacMAME ROM image files from those on the net.
  47.  
  48. For a complete list of acknowledgements, please check the file 'readme.txt' that is in the Documentation folder -- it contains the instructions, thank-you's and info for the current MAME release.
  49.  
  50. The source code is freely distributed so if you see any bugs or areas of improvement in these modules, please let me know!
  51.  
  52. If you are interested in programming emulations, you must check out the emulation programming repository at: http://www.dct.com/~mhalse/EmuProgramming
  53.  
  54. How do I play MacMAME?
  55.  
  56. Here's a quick breakdown of the keys:
  57.  
  58. 3 - insert a Quarter
  59. 1 & 2 - 1 and 2 player start
  60. ESC - Pause
  61. TAB - access configuration menu
  62. F3 - reset the emulated machine
  63. F4 - show the charsets. Use the arrows to navigate through the various combinations, ESC to return to the game
  64. F8 - cycle through frameskip options
  65. F9 - cycle through the volume levels
  66. F10 - toggle speed throttling
  67. F11 - toggle FPS
  68. F12 - save a screenshot
  69.  
  70. The keys may be configured for each game. Press TAB to get to the configuration menu to change the key settings and also view the key settings for each game. Most games use the arrows to move and control to fire.
  71.  
  72. The interlaced video option only affects 2x2 window sizes that fit entirely onto the screen or when you've hidden the desktop. For best results, use a resolution of 800x600 or higher with the 2x2 option.
  73.  
  74. The 'Sound Samples' folder contains subfolders with samples from games. These are distributed in separate archives, available from my MacMAME page. The proper folder names for the sound samples (for those games that support it) are listed in the file 'readme.txt' next to each supported game.
  75.  
  76. Common Questions
  77.  
  78. Q: When I start a game, it says that the file "xxx" could not be opened! What's wrong?
  79. A: MacMAME is looking for a specific ROM file for that game but it did not find it. Look around on the net for arcade game ROM archives and you're sure to find the proper files. Some games are harder to find than others though. 
  80.  
  81. Q: I downloaded ROMs for "xxx" but MacMAME says this game isn't supported. What's wrong?
  82. A: Check the file "readme.txt" to see if that game is actually supported. MacMAME won't work with every arcade game - it needs to be written to specifically support games.
  83.  
  84. Q: MacMAME says game "xxx" is not supported, but it used to work! What happened?
  85. A: MacMAME needs to know the driver name for each game. It looks for this information either in the ROM file made by MAME Converter or it uses the folder name of the ROM set in the ROMs folder. Most likely, the ROM driver name was changed for the current release so the old name is no longer recognized. The solution is to rename the folder of ROMs and create a new ROM file with MAME Converter - you can find a listing of the driver names in the file "readme.txt" in the Documentation folder.
  86.  
  87. Q: How do I get the sound samples to work?
  88. A: Download the sound samples from the internet and unzip them with any unzipping utility like Stuffit Expander or ZipIt. It will create a folder that you must drop in the Sound Samples folder. This new folder must match the "driver" name for the game you are playing or MacMAME won't be able to find them. The "driver" names are listed in the file "readme.txt" in the Documentation folder.
  89.  
  90. Q: I've downloaded the sound samples, renamed the file properly, but still no sound! What is wrong?
  91. A: MacMAME doesn't support sound samples for every game - check "readme.txt" to see which games use sound samples and which don't.
  92.  
  93. Q: Where is the music in Ghosts & Goblins and Commando?
  94. A: Not here yet. Maybe in a future version of MacMAME. The YM-2203 sound chip isn't emulated on the Mac yet. The PC source is written in intel assembly language and relies on the oddities of PC sound cards to work right.
  95.  
  96. Q: Where can I talk about MAME on the internet?
  97. A: If you use IRC, there is a MAME channel at #mamegames. Look for me as "hoserama". If Usenet news is your thing, try comp.emulators.misc or alt.emulators.classic-arcade.
  98.  
  99. Q: What happened to support for non-PowerMacs?
  100. A: It was dropped because it was getting harder to maintain the code to handle it. Now that it's gone, several PowerPC-specific speedups have been implemented to take full advantage of the chip's speed.
  101.  
  102. Wanted:
  103.  
  104. • If you have technical details of how an arcade machine works that you'd like to see, feel free to write a driver for it! We'd be more than happy to include it in the next MAME distribution.
  105.  
  106. Known Mac-specific Bugs:
  107.  
  108. • None right now.
  109.  
  110. Technical Details:
  111.  
  112. The emulator engine is based on Z80, 6502, 8088/8086, 6809 and 68000 processors. Some sound routines use the 8910 & Pokey sound chips. The IREM games use an additional 6803 CPU to send commands to the 8910 sound chip, while the Williams games use an additional 6808 to generate the samples directly.
  113.  
  114. Brad Oliver
  115. 10/20/97
  116.